home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / xtros2.zip / XTROS2.DOC < prev   
Text File  |  1992-12-30  |  19KB  |  572 lines
  1.  
  2. Filename: XTROS2.DOC
  3. Product:  Xtrieve PLUS v4.11 for OS/2
  4. Date:      December 1992
  5.  
  6.    This Readme document accompanies the OS/2 environment patches for Xtrieve
  7.    PLUS v4.11 programs and utilities.
  8.  
  9.  
  10. ================================================================================
  11. Disclaimer
  12. ==========
  13.  
  14.    Novell, Inc. makes no representations or warranties with respect to any
  15.    NetWare software, and specifically disclaims any express or implied
  16.    warranties of merchantability, title, or fitness for a particular purpose.
  17.  
  18.    Distribution of any NetWare software is forbidden without the express written
  19.    consent of Novell, Inc.  Further, Novell reserves the right to discontinue
  20.    distribution of any NetWare software.
  21.  
  22.    Novell is not responsible for lost profits or revenue, loss of use of the
  23.    software, loss of data, costs of re-creating lost data, the cost of any
  24.    substitute equipment or program, or claims by any party other than you.
  25.    Novell strongly recommends a backup be made before any software is installed.
  26.    Technical support for this software may be provided at the discretion of
  27.    Novell.
  28.  
  29.    PATCH.EXE is a proprietary product of PocketSoft.  PATCH.EXE and Patch Build
  30.    generated files are distributed by Novell, Inc. under license from
  31.    PocketSoft.
  32.  
  33.  
  34. ================================================================================
  35. Contents
  36. ========
  37.  
  38.    Installation Procedure
  39.    Patch File Information
  40.    Original File Information
  41.    Patch Set Descriptions
  42.    Documentation Updates
  43.  
  44.  
  45. ================================================================================
  46. Installation Procedure
  47. ======================
  48.  
  49.    The PATCHXTR.CMD and PATCH.EXE files mentioned in this procedure require
  50.    OS/2 v1.1 or later.
  51.  
  52.    The XTROS2.ZIP file contains the following:
  53.  
  54.    -  This Readme document
  55.    -  PATCH.EXE, a utility Novell provides for installing product patches
  56.    -  PATCHXTR.CMD, a batch file to facility patch installation
  57.    -  Patch files (XTRIEVE.411 and XQLCALLS.211)
  58.    -  Replacement files (files with the same names as the files they will
  59.       replace)
  60.  
  61.    To install the Xtrieve PLUS patch set, complete the following steps:
  62.  
  63.    1.  Create a directory on your system, and copy the XTROS2.ZIP file to
  64.        that directory.
  65.  
  66.    2.  Use the utility PKUNZIP.EXE to unzip the zipped files.
  67.  
  68.    3.  Install the patch files (XTRIEVE.411 and XQLCALLS.211) as follows:
  69.  
  70.        a.  Refer to the list of patch files in the section "Original File
  71.        Information," find the original files on your system, and ensure that
  72.        your original files match those listed.
  73.  
  74.        b.  Use the DOS COPY command to copy the original files into the
  75.        directory that contains the unzipped patch files from XTROS2.ZIP.
  76.  
  77.        c.  Run PATCHXTR, which verifies that you are patching the original
  78.        released version of the software, applies the patch, and gives the
  79.        original files an .ORG extension.
  80.  
  81.        d.  Use the DOS COPY command to copy the patched files back to the
  82.        original file's directory.
  83.  
  84.    4.  Install the replacement files as follows:
  85.  
  86.        a.  Find the directory that contains the original files to be
  87.        replaced.
  88.  
  89.        b.  Before copying the replacement files, back up the original files
  90.        to a diskette or to another directory.
  91.  
  92.        c.  Use the COPY command to replace the original files with the
  93.        new files.
  94.  
  95.    5.  After applying the patches, you can remove the directory you created to
  96.        store the XTROS2.ZIP file.  You may also want to verify the version
  97.        numbers when you load each program.  The version numbers should match
  98.        those listed in the next section, "Patch File Information."
  99.  
  100.  
  101. ================================================================================
  102. Patch File Information
  103. ======================
  104.  
  105.    Patch Set Filename:    XTROS2.ZIP
  106.  
  107.    Date:        12-30-92
  108.  
  109.    Files Included:    XTROS2     DOC           This document
  110.             PATCH     EXE           76981   1-30-92      5:00a
  111.             PATCHXTR CMD        3928  12-17-92      3:55p
  112.  
  113.       (Patch file)    XTROS2     411  v4.11b   64874   12-17-92  11:06a
  114.             XQLCALLS 211         538   12-17-92   3:27p
  115.  
  116.    (Replacement files)    MAKE_XTA EXE  v4.11b   74858   12-09-92  10:54a
  117.             XCFP     EXE  v4.11b   57548   12-09-92  11:19a
  118.             XMENU     EXE  v4.11b  133592   12-09-92  11:14a
  119.             XTRIEVE  MSG           39018   12-08-92   5:06p
  120.             XTRIEVE  MEN  v4.11b   13347   12-08-92   5:06p
  121.             XHFP     EXE  v4.11b   26192   12-09-92  11:17a
  122.  
  123.  
  124. ================================================================================
  125. Original File Information
  126. =========================
  127.  
  128.    To ensure you are patching the original file, compare the file to be patched
  129.    with that in the following list.  This list shows the byte size and the date
  130.    and time stamps for the original release.
  131.  
  132.    Patch these files:
  133.             XTRIEVE  EXE   v4.11  464362    8-13-92   11:21a
  134.             XQLCALLS ORG   v2.11  399291   10-18-90   12:28p
  135.  
  136.    Replace these files:
  137.             MAKE_XTA EXE   v4.11   71738    6-25-92    7:45p
  138.             XCFP     EXE   v4.11   56994    6-25-92    8:07p
  139.             XMENU     EXE   v4.11  133592    9-16-92   12:57p
  140.             XTRIEVE  MSG           39017    8-11-92    3:59p
  141.             XTRIEVE  MEN   v4.11   13347    8-11-92    3:59p
  142.             XHFP     EXE   v4.11   26192    6-25-92    8:06p
  143.  
  144.  
  145. ================================================================================
  146. Patch Set Descriptions
  147. ======================
  148.  
  149.    This section describes each patch in the patch set.    The patch descriptions
  150.    for the Xtrieve engine appear first, followed by those for the utilities.
  151.  
  152.    For each patch, the description includes one or more search strings.  These
  153.    search strings indicate areas in which you may encounter the problem that the
  154.    patch addresses.  The search strings may help you quickly determine whether
  155.    the patch you need for a specific problem is included in this patch set.
  156.  
  157.    NOTE:  In some cases, the text describes a problem or reported bug that the
  158.       update does NOT fix.    In those cases, use the workaround provided.
  159.  
  160.    * * * * * * * * *
  161.  
  162.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  163.  
  164.    Search String:  DISPLAY ERRORS
  165.  
  166.    Problem:
  167.  
  168.    In the Report Layout screen, when you insert a field between two fields that
  169.    take up a relatively large portion of the screen, Xtrieve PLUS redraws the
  170.    screen incorrectly.    This patch does not contain a fix; Xtrieve PLUS
  171.    accurately stores the new data.
  172.  
  173.    * * * * * * * * *
  174.  
  175.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  176.  
  177.    Search Strings:  F8, HANG, MODIFYING, REPORT LAYOUT
  178.  
  179.    Problem Fixed by This Patch:
  180.  
  181.    When you repeatedly use the key sequence Shift+F8, F8, and Esc when modifying
  182.    or viewing groups or fields in a report layout, Xtrieve PLUS terminates.
  183.    This patch ensures that Xtrieve PLUS properly closes and reopens the report
  184.    layout windows, thus preventing Xtrieve PLUS from terminating.
  185.  
  186.    * * * * * * * * *
  187.  
  188.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  189.  
  190.    Search Strings:  GROUP FIELD, GROUP SUMMARY, REPORT FIELD, REPORT SUMMARY
  191.  
  192.    Problem Fixed by This Patch:
  193.  
  194.    If you use a report field in a report field summary or a group field in a
  195.    group field summary, Xtrieve PLUS does not allow you to remove or modify the
  196.    field.  This patch ensures that Xtrieve PLUS allows you to remove or modify
  197.    such fields.
  198.  
  199.    * * * * * * * * *
  200.  
  201.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  202.  
  203.    Search Strings:  FORM/ADD EDIT SCREEN, INVALID RECORD
  204.  
  205.    Problem Fixed by This Patch:
  206.  
  207.    If you attempt to add an invalid record using the Form/Add edit screen,
  208.    Xtrieve PLUS exits the Form/Add edit screen and returns to the Form menu.
  209.    This patch ensures that if an error occurs when you attempt to add a record,
  210.    Xtrieve PLUS remains at the edit screen.
  211.  
  212.    * * * * * * * * *
  213.  
  214.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  215.  
  216.    Search String:  REPORT LAYOUT
  217.  
  218.    Problem Fixed by This Patch:
  219.  
  220.    When XQL and Btrieve are loaded by Xtrieve PLUS, a report layout may become
  221.    corrupt in memory after you print the report.  This patch ensures that
  222.    Xtrieve PLUS correctly maintains report layouts.
  223.  
  224.    * * * * * * * * *
  225.  
  226.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  227.  
  228.    Search String:  REMOVE GROUP
  229.  
  230.    Problem Fixed by This Patch:
  231.  
  232.    If you remove a group from a report and then attempt to remove another
  233.    group, Xtrieve PLUS displays a repetitive list of groups from which to
  234.    choose.  In addition, if you choose one of the listed groups, Xtrieve PLUS
  235.    causes the workstation to freeze.  This patch ensures that Xtrieve PLUS
  236.    correctly displays lists of groups.
  237.  
  238.    * * * * * * * * *
  239.  
  240.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  241.  
  242.    Search Strings:  BLANKS, IMPORT DATA, SDF
  243.  
  244.    Problem Fixed by This Patch:
  245.  
  246.    Xtrieve PLUS incorrectly imports data in Standard Data Format (SDF) if
  247.    blanks separate the data elements, as in the following example:
  248.  
  249.    "Firstname", "Middlename", "Lastname"
  250.  
  251.    This patch ensures that Xtrieve PLUS correctly imports SDF data.
  252.  
  253.    * * * * * * * * *
  254.  
  255.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  256.  
  257.    Search Strings:  LVAR, NOTE, TRANSLATE, VARIABLE-LENGTH FIELDS
  258.  
  259.    Problem Fixed by This Patch:
  260.  
  261.    Xtrieve PLUS does not accurately perform view-to-view translations on
  262.    variable-length fields that are not of the same type.  For example, you
  263.    cannot accurately translate a note field into an lvar field.  This patch
  264.    ensures that Xtrieve PLUS correctly performs such translations.
  265.  
  266.    * * * * * * * * *
  267.  
  268.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  269.  
  270.    Search Strings:  CREATE FILE, PAGE, PREALLOCATION
  271.  
  272.    Problem Fixed by This Patch:
  273.  
  274.    When you are creating files, Xtrieve PLUS allows you to preallocate no more
  275.    than 32,767 pages.  This patch ensures that Xtrieve PLUS allows you to
  276.    preallocate up to 65,535 pages.
  277.  
  278.    * * * * * * * *
  279.  
  280.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  281.  
  282.    Search Strings:  BTRIEVE, NEW COMMAND LINE OPTIONS, UNLOAD, XQL
  283.  
  284.    Problem Fixed by This Patch:
  285.  
  286.    Xtrieve PLUS does not unload Btrieve or XQL from memory if you loaded Btrieve
  287.    or XQL before you entered Xtrieve PLUS.  If you do not have the utilities
  288.    BUTIL or NSUTIL, you cannot unload XQL or Btrieve from memory.  This patch
  289.    makes available two new command line options you can specify when you load
  290.    Xtrieve PLUS:
  291.  
  292.    /ua       Unloads both XQL and Btrieve when you exit Xtrieve PLUS
  293.  
  294.    /ux       Unloads only XQL when you exit Xtrieve PLUS
  295.  
  296.    * * * * * * * * *
  297.  
  298.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  299.  
  300.    Search Strings:  CONDITIONAL, FIELD LIST, SCALAR FUNCTIONS,
  301.             USER-DEFINED FIELDS
  302.  
  303.    Problem:
  304.  
  305.    Xtrieve PLUS may not display all available fields in a field list when you
  306.    are defining a user-defined field that includes nested conditions or nested
  307.    scalar functions, as in the following example expression:
  308.  
  309.    Result = SUBSTRING( SUBSTRING( SUBSTRING( Field3,5,20),2,Field2),5,Field1)
  310.  
  311.    Workaround:
  312.  
  313.    For each level of nesting, create a temporary, user-defined field, as in the
  314.    following example:
  315.  
  316.    TempField1 = SUBSTRING( Field3,5,20)
  317.  
  318.    TempField2 = SUBSTRING( TempField1,2,Field2)
  319.  
  320.    TempField3 = SUBSTRING( TempField2,5,Field1)
  321.  
  322.    Since Xtrieve PLUS embeds the temporary field definitions in the substring
  323.    field that references it, you can delete the interim temporary fields,
  324.    resulting in a single, user-defined field, as in the following example:
  325.  
  326.    Result = TempField3
  327.  
  328.    * * * * * * * * *
  329.  
  330.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  331.  
  332.    Search Strings:  DECIMAL POINTS, INTEGER FIELDS, MASKS
  333.  
  334.    Problem:
  335.  
  336.    If you place a mask that contains decimal points (such as ZZZ,ZZ9.99) on an
  337.    integer field, you may get unexpected results in report summary fields.  For
  338.    example, if the field's data is 38,470.00, the masked result is 384.70.
  339.  
  340.    Workaround:
  341.  
  342.    Masks on integer fields should not contain decimal points.  Use a more
  343.    appropriate data type, such as decimal, float, money, or numeric.
  344.  
  345.    * * * * * * * * *
  346.  
  347.    Product/Platform:  OS/2 - XQLCALLS.DLL
  348.  
  349.    Search Strings:
  350.  
  351.    Problem Fixed by This Patch:
  352.  
  353.  
  354.  
  355.    * * * * * * * * *
  356.  
  357.    Product/Platform:  OS/2 - XTRIEVE.PDB
  358.  
  359.    Search Strings:  PRINTER, TABLOID SETTING
  360.  
  361.    Problem:
  362.  
  363.    The Tabloid setting of the XTRIEVE.PDB file specifies the Epson LQ-1500/2.0
  364.    printer instead of the IBM PC graphics printer.
  365.  
  366.    Workaround:
  367.  
  368.    Change the Tabloid setting as follows.
  369.  
  370.    1.  At a DOS workstation, enter SLATE XTRIEVE.PDB.
  371.  
  372.    2.  In the SLATE utility, follow these steps to set the Tabloid setting:
  373.  
  374.        a.  Select the Add/Edit Devices (Ptr Connections) option from the main
  375.        menu.
  376.  
  377.        b.  Select the 3001 Tabloid option from the Devices menu.
  378.  
  379.        c.  Use the Tab key to move to the Ptr Mfg field and press F9 to display
  380.        a list of printer manufacturers.
  381.  
  382.        d.  Select IBM.
  383.  
  384.        e.  Use the Tab key to move to the Ptr Type field and press F9 to display
  385.        a list of printer types.
  386.  
  387.        f.  Select PC Graphics Printer.
  388.  
  389.    3.  To exit SLATE, press F10 three times.
  390.  
  391.    * * * * * * * * *
  392.  
  393.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  394.  
  395.    Search Strings:  3, HANG, OPEN VIEWS
  396.  
  397.    Problem Fixed by This Patch:
  398.  
  399.    The MAKE_XTA utility hangs or returns Status Code 3 (File Not Open) when you
  400.    attempt to open certain views.  This patch ensures that MAKE_XTA can open
  401.    such views.
  402.  
  403.    * * * * * * * * *
  404.  
  405.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  406.  
  407.    Search Strings:  FIELD NAMES, LOWERCASE, UPPERCASE
  408.  
  409.    Problem Fixed by This Patch:
  410.  
  411.    The MAKE_XTA utility converts all letters in user-defined field names to
  412.    uppercase.  This patch ensures that MAKE_XTA preserves lowercase letters in
  413.    field names.
  414.  
  415.    * * * * * * * * *
  416.  
  417.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  418.  
  419.    Search Strings:  EQJOIN, EQUAL, JOIN, KEYWORD, NULL, NULLJOIN
  420.  
  421.    Problem Fixed by This Patch:
  422.  
  423.    The MAKE_XTA utility inserts incorrect keywords in .XTA files that contain
  424.    file joins.    For example, MAKE_XTA uses the keyword EQUAL when it should use
  425.    the keyword EQJOIN.    This patch ensures that MAKE_XTA inserts the correct
  426.    keywords.
  427.  
  428.    * * * * * * * * *
  429.  
  430.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  431.  
  432.    Search Strings:  ADD KEYWORD, REPORT LAYOUT, SUM
  433.  
  434.    Problem Fixed by This Patch:
  435.  
  436.    If a report layout contains the calculation type SUM, the MAKE_XTA
  437.    utility inserts an extra .ADD. keyword in the XTA file.  This patch ensures
  438.    that MAKE_XTA inserts the correct number of .ADD. keywords.
  439.  
  440.    * * * * * * * * *
  441.  
  442.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  443.  
  444.    Search Strings:  BIT FIELDS, CONSECUTIVE FIELDS
  445.  
  446.    Problem Fixed by This Patch:
  447.  
  448.    If a dictionary contains two or more adjacent fields of type bit, the
  449.    MAKE_XTA utility inserts only the first bit field in the .XTA file.    This
  450.    patch ensures that MAKE_XTA inserts all bit fields.
  451.  
  452.    * * * * * * * * *
  453.  
  454.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  455.  
  456.    Search Strings:  AUTOINC, INDEX ATTRIBUTES
  457.  
  458.    Problem Fixed by This Patch:
  459.  
  460.    The MAKE_XTA utility incorrectly extracts the index attributes of fields of
  461.    type autoinc.  This patch ensures that MAKE_XTA retains index attributes as
  462.    defined in the original file.
  463.  
  464.    * * * * * * * * *
  465.  
  466.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  467.  
  468.    Search Strings:  EXTRACT FILES, SUPPLEMENTAL INDEX
  469.  
  470.    Problem Fixed by This Patch:
  471.  
  472.    The MAKE_XTA utility fails when attempting to extract files that contain
  473.    supplemental indexes.  This patch ensures that MAKE_XTA correctly extracts
  474.    supplemental indexes.
  475.  
  476.    * * * * * * * * *
  477.  
  478.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  479.  
  480.    Search String:  DESCRIPTIVE FILENAME
  481.  
  482.    Problem Fixed by This Patch:
  483.  
  484.    If a descriptive filename is shorter than the actual filename, the MAKE_XTA
  485.    utility pads the rest of the descriptive filename with characters from the
  486.    actual filename.  For example, given a descriptive filename of FILE and an
  487.    actual filename of TESTING, MAKE_XTA converts the descriptive filename to
  488.    FILEING.  This patch ensures that MAKE_XTA inserts the correct descriptive
  489.    filename into the generated .XTA file.
  490.  
  491.    * * * * * * * * *
  492.  
  493.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  494.  
  495.    Search Strings:  EXTRACT VIEWS, USER-DEFINED FIELDS
  496.  
  497.    Problem Fixed by This Patch:
  498.  
  499.    The MAKE_XTA utility incorrectly extracts files containing relatively large
  500.    user-defined fields.  This patch ensures that MAKE_XTA correctly extracts
  501.    such files.
  502.  
  503.    * * * * * * * * *
  504.  
  505.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  506.  
  507.    Search Strings:  CONDITIONAL USER-DEFINED FIELDS, MASKS
  508.  
  509.    Problem:
  510.  
  511.    If you define a conditional user-defined field in Xtrieve PLUS and you define
  512.    a mask for the field, MAKE_XTA does not maintain the mask when it creates the
  513.    .XTA file.
  514.  
  515.    Workaround:
  516.  
  517.    Edit the .XTA file to restore the mask definitions for each conditional
  518.    user-defined field you want masked.
  519.  
  520.    * * * * * * * * *
  521.  
  522.    Product/Platform:  OS/2 - XCFP.EXE, v4.11
  523.  
  524.    Search Strings:  COMMANDS WITH NUMERALS, PAGE SIZE
  525.  
  526.    Problem Fixed by This Patch:
  527.  
  528.    The Xtrieve PLUS Command File Processor (XCFP) utility does not recognize the
  529.    command that specifies page size since the command begins with a numeral.
  530.    This patch ensures that XCFP recognizes commands that begin with numerals.
  531.  
  532.  
  533. ================================================================================
  534. Documentation Updates
  535. =====================
  536.  
  537.    NOTE:  The documentation updates that follow are in addition to any
  538.           documentation updates noted in the Readme file of the original
  539.           product.
  540.  
  541.    Note the following change to the "Xtrieve PLUS User's Manual:"
  542.  
  543.    -  Page A-49:  Add the following status codes.
  544.  
  545.       349  The Specified Data Value Is Too Large for the Field Definition
  546.  
  547.        The data value you specified is larger than the maximum length
  548.        defined for the field.
  549.  
  550.       350  Security Has Not Been Enabled on This Dictionary
  551.  
  552.        You attempted an operation that can be done only when security is
  553.        enabled.  Database security is not enabled at this time.  To perform
  554.        the operation successfully, enable security on that database.
  555.  
  556.       351  A Transaction Has Not Yet Been Started
  557.  
  558.        You attempted to perform a COMMIT or ROLLBACK operation without being
  559.        inside a transaction.  You must start a transaction before you can
  560.        perform a COMMIT or ROLLBACK operation.  To start a transaction,
  561.        issue a START TRANSACTION operation.
  562.  
  563.       352  Record Count Must Be Greater Than Zero
  564.  
  565.        NetWare SQL received a record count value for the xFetch call that is
  566.        not more than zero.    The record count for an xFetch call must be at
  567.        least 1.
  568.  
  569.  
  570. ** End of XTROS2.DOC **
  571.  
  572.